home *** CD-ROM | disk | FTP | other *** search
/ Zoom 2 / Zoom - Release 2 (1996)(Active Software)[!].iso / graphics / raytracing / 3dconvertors / readme.r43 < prev    next >
Text File  |  1995-02-01  |  14KB  |  297 lines
  1.  
  2.     Release #43 of T3DLIB may be the last release I generate.
  3. Many thanks to the few people who have registered their copy of it.
  4. I very much appreciate it!  See the CHANGES file for more information.
  5.  
  6.                             -- Glenn
  7.                         glewis@pcocd2.intel.com
  8.                         glewis@netcom.com
  9.  
  10. ==========================================================================
  11.  
  12. NEWS FLASH!
  13.  
  14.     As of release #38 of T3DLIB, I have decided to change what I release.
  15. To promote the users of T3DLIB to register this ShareWare with me, I have
  16. decided to not release the entire collection of goodies with the public
  17. release.  Then, when people register, I will either e-mail (if possible)
  18. the other goodies, or mail them on a floppy.
  19.     Of course, all currently registered T3DLIB users can simply send me
  20. e-mail and I will e-mail them back the latest collection of T3DLIB goodies,
  21. or if you do not have access to e-mail, then please mail me a blank floppy
  22. disk, and I will be happy to fill it up and mail it back to you, without
  23. further charge.
  24.     Please see the CHANGES file to see what is new in this release.  Of
  25. particular interest may be that I now support reading and writing of
  26. Imagine staging files.
  27.  
  28.     The "goodies" that are currently being "held back" are:
  29. 1) bumpit - algorithmically perturbs the points of an object - great for morphs
  30. 2) spherize - confines points of an object to a unit sphere - great for morphs
  31. 3) mbb - calculates and prints the Minimum Bounding Box of an object
  32. 4) set_texture_path - (re)sets the root path of all textures in an object
  33. 5) set_brush_path - (re)sets the root path of all brushmaps and stencils in object
  34.  [as of R39...]
  35. 6) texit - applies Imagine 2.0 texture to an object (No source provided)
  36.  
  37.     So please register, and enjoy T3DLIB!  Thanks!
  38.  
  39.     And now I return you to the portion you may have already read...
  40.  
  41.                                                         -- Glenn
  42.  
  43. ==========================================================================
  44. ==========================================================================
  45. ==========================================================================
  46.  
  47. This is an lzh file containing a set of programs called T3DLIB (previously
  48. known as TTDDDLIB).  These programs convert 3D objects in the binary TDDD
  49. format into the Textual TDDD (TTDDD) format and back again, and also
  50. provide a number of other conversion filters.
  51.  
  52. -----------------------------------
  53.  
  54. These programs are provided as SHAREWARE. If you choose to use these programs,
  55. you are obligated to send in a $25 (US) to the author, Glenn Lewis.
  56. His address:
  57.  
  58.    Glenn M. Lewis
  59.    8341 Olive Hill Court
  60.    Fair Oaks, CA  95628
  61.    (USA)
  62.  
  63. Glenn is also reachable via email at glewis@pcocd2.intel.com.
  64.  
  65. ----------------
  66.  
  67. Enjoy these programs and the objects, and send in your Shareware fee to Glenn!
  68.  
  69. [condensed message from...]
  70. -Steve
  71.  
  72. --------------------------------------------------------------------------
  73. Steve Worley                                         Worley@cup.portal.com
  74. --------------------------------------------------------------------------
  75.  
  76.  
  77.     As of March 31, 1992, I have included the Amiga executables of the latest
  78. revision of T3DLIB in the files:
  79.  
  80.   T3DLIB*_68000exe.lha  (68000, non-FPU version)
  81.   T3DLIB*_68030exe.lha  (68030, FPU version)
  82.  
  83.     Note that these were compiled with SAS/C, and so they do not have that bogus
  84. restriction of running only under version 2.04 of the operating system like the
  85. R33 version of the executables had!
  86. Yahoo!  Thanks, Scott!
  87.  
  88.     You will find several filters in there, all of which support Imagine
  89. objects (and, of course, Turbo Silver objects).  The most important filter you
  90. will use is called "readwrite", which basically replaces the old ReadTDDD and
  91. WriteTDDD programs.
  92.  
  93.     "ReadWrite" will read from its standard input, *EITHER* an Imagine object
  94. file *OR* a TTDDD file, and it is smart enough to know which is which without
  95. you telling it.  (In fact, all of the executables from T3DLIB now read
  96. either type of file!)  It will also read old Turbo Silver files, and make all
  97. external objects internal.
  98.  
  99.     "readwrite" will, by default, output TTDDD files to its standard output.
  100. But if you give it the "-tddd" flag (or "-t" for short), it will output
  101. Imagine object files directly!
  102.  
  103.     Remember that all of these programs are filters, so you must redirect
  104. their input and output from/to files.
  105.  
  106.     readwrite   - reads and writes both TDDD and TTDDD files
  107.     tddd2mif    - reads TDDD or TTDDD files and outputs FrameMaker MIF files
  108.     tddd2ps     - reads TDDD or TTDDD files and outputs isometric wireframes
  109.                   with Top, Front, Right, and Isometric views in PostScript
  110.     tddd2nff    - reads TDDD or TTDDD files and outputs NFF files
  111.     tddd2off    - reads TDDD or TTDDD files and outputs OFF files
  112.     tddd2ray    - reads TDDD or TTDDD files and outputs Rayshade 4.0 files
  113.     tddd2vort   - reads TDDD or TTDDD files and outputs VORT files
  114.  
  115. Two new filters as of release 34 are:
  116.     tddd2dxf    - reads TDDD or TTDDD files and outputs DXF (AutoCAD) files
  117.     tddd2pov    - reads TDDD or TTDDD files and outputs POV-Ray 1.0 files
  118.  
  119. Here is some documentation on the OFF and NFF versions:
  120.  
  121. TDDD is a complex format that allows heirarchical structure to be
  122. defined. Thus, a car might be defined as different parts, such as the
  123. frame, the doors, the tires, and the windows. When you are converting
  124. from TDDD, sometimes you will want to merge all of the sub-parts together
  125. to form one single object, but other times it is convienient to have the
  126. different parts saved as seperate objects so you can manipulate them 
  127. easier. T3DLIB supports both conversion methods by a flag, -split. 
  128.  
  129. The programs included:
  130.  
  131. 1) tddd2off
  132.  
  133. Usage: tddd2off [-geom_only] [-split] [infile] [outfile]
  134.  
  135.    Converts an input TDDD or TTDDD file to an OFF format file. It defaults
  136.    to outputting both a .geom and a .ipcol file, but if you are only
  137.    interested in the structure of the object, the flag -geom_only
  138.    (or -g) will ouput only the point, edge, and face information.
  139.    -split will split heirarchical objects into individual objects.
  140.    In this case, if the outfile name is "model", the output names
  141.    would be "model001.geom", "model002,geom", etc. 
  142.  
  143. 2) tddd2nff
  144.  
  145. Usage: tddd2nff [infile] [outfile]
  146.  
  147.    Converts an input TDDD or TTDDD file and saves an NFF format file.
  148.  
  149. -------------------------------------------------------------------------
  150.  
  151.     Althought the following does not cut it for documentation (hopefully
  152. I will have some real docs by the next release...), I thought this might
  153. be helpful to some people:
  154.  
  155. >>>>> On Wed, 24 Jun 92 13:23:29 -0400, kelly@ll.mit.edu said:
  156.  
  157. Dave> Greetings;
  158.  
  159. Dave>         Can anyone out there tell me a little about the program
  160. Dave> TTDDD?  Specifically what kinds of things can be done with it
  161. Dave> (especially by none programmers such as myself). I downloaded some
  162. Dave> nice 3D fonts from hubcap that were converted from TeX with TTDDD.
  163. Dave> Is this the kind of thing that I could do with little or no
  164. Dave> programming? Also what other programs/excessories would be useful
  165. Dave> with TTDDD? Thanks for the help!
  166.  
  167.         Hi!  I am Glenn Lewis, the author of TTDDD and T3DLIB (previously
  168. known as "TTDDDLIB").  I thought I would post to the list so that
  169. everybody would be up-to-date.
  170.  
  171.         Basically, the old TTDDD programs, called "ReadTDDD" and
  172. "WriteTDDD" are obsolete, and do not support any of the new Imagine
  173. sub-chunks.  Let me give you a summary of what T3DLIB can do for you
  174. from my point of view, which is obviously quite biased.
  175.  
  176.         First, T3DLIB consists of two things: a linkable library of
  177. routines that allow programmers to manipulate 3D objects and scenes
  178. easily from within their own applications.  (Of course if you wish to
  179. use my code in a commercial product, you must check with me first, as
  180. one author failed to do.)  The second part of T3DLIB is a collection of
  181. filters that are built using the linkable library.  T3DLIB supports
  182. (reads/writes) most all "chunks" in the Imagine TDDD file format.
  183.  
  184.         The source code (and executables that run under *BOTH* 2.04 and 1.3
  185. of the Amiga operating system without any special libraries) are available on
  186. hubcap.clemson.edu [130.127.8.1] in the directory:
  187. pub/amiga/incoming/imagine/TTDDDLIB.  Also, many people have contributed
  188. some really nice programs that use or enhance T3DLIB.  Please look in the
  189. subdirectory called "contrib" on hubcap for a few of these.
  190. [NOTE: I have added a few of these programs to the registered T3DLIB disk.]
  191.  
  192.         The main program included in T3DLIB is called "ReadWrite".  This
  193. is the one that makes the previous two programs obsolete, as mentioned
  194. above.  "ReadWrite" is simply a filter, but a powerful one.  First off,
  195. I better describe what the TTDDD format is: TTDDD is "Textual TDDD", and
  196. "TDDD" is an IFF (Interchange File Format [?]) that has many "chunks"
  197. and "sub-chunks" that describe objects and scene for Imagine (and
  198. previously Turbo Silver).  "TDDD" was created by Impulse, Inc.  TTDDD
  199. was created by me, and allows any text file to describe in full detail,
  200. all that a TDDD file can describe, but is editable and can be
  201. algorithmically generated.
  202.  
  203.         Back to "ReadWrite"...  ReadWrite reads a file from its standard
  204. input, and writes a file to its standard output.  The input file can be
  205. *either* a TTDDD *or* a TDDD file, and the output, by default, is a
  206. TTDDD file.  If "ReadWrite" is given the "-tddd" (or "-t" for short)
  207. flag on its command line, it will write a TDDD file that is directly
  208. loadable by Imagine.  Since Imagine does not support "external" objects
  209. like Turbo Silver did, "ReadWrite" will load any "external" objects at
  210. that time and make them internal to make Imagine happy.  Also, if one
  211. wishes to "optimize" points and edges (by simply removing redundancies),
  212. the "-m" (for "merge") flag will accomplish this.  This does, however,
  213. take much longer processing time, so sit back and let it crunch on the
  214. object(s).
  215.  
  216.         This, obviously, is the most useful (and necessary) program for
  217. dealing with TTDDD and TDDD files.  Here is a list of other utilities
  218. that are included:
  219.  
  220. tddd2off tddd2nff tddd2vort tddd2ray tddd2ps tddd2mif tddd2dxf tddd2pov
  221.  
  222.         All of the above are also filters, and perform the following
  223. conversions:
  224.  
  225. tddd2off  - converts TDDD (or TTDDD automatically) to OFF format
  226. tddd2nff  - converts TDDD (or TTDDD automatically) to NFF format
  227. tddd2vort - converts TDDD (or TTDDD automatically) to VORT format
  228. tddd2ray  - converts TDDD (or TTDDD automatically) to Rayshade 4.0 format
  229. tddd2ps   - converts TDDD (or TTDDD automatically) to PostScript format
  230. tddd2mif  - converts TDDD (or TTDDD automatically) to MIF format
  231. tddd2dxf  - converts TDDD (or TTDDD automatically) to DXF (AutoCAD) format
  232. tddd2pov  - converts TDDD (or TTDDD automatically) to POV-Ray format
  233.  
  234. OFF is DEC's Object File Format.
  235. NFF is Eric Haines' (SP?) Neutral File Format.
  236. VORT is the "Very Ordinary Ray Tracer", I believe.
  237. Rayshade is that awesome program by Craig Kolb.
  238. PostScript output has 4 views: Top, front, right, and isometric.
  239. MIF is "Maker Interchange Format" for FrameMaker, and looks like the
  240.     PostScript output, but is editable from within FrameMaker.
  241. DXF is AutoCAD's interchange file format.
  242. POV is POV-Ray's file format.
  243.  
  244.         The entire T3DLIB package is shareware, and costs $25 to
  245. register.  Details are in the sources archive on hubcap.  As a "Thank You" 
  246. for registering, I will send you a disk with the two utilities: TSTeX
  247. (which created the font you viewed on hubcap from public domain TeX
  248. fonts [in PK format]) and SQuad, which generates superquadric surfaces
  249. based upon parameters that you supply it.  Examples of superquadrics are
  250. torii, cubes (with rounded edges), diamonds, and a sphere is a
  251. degenerate superquadric.  I will also send you a copy of the TDDD file
  252. format, which is basically the documentation for the TTDDD file format,
  253. as it uses the same names, but is editable.  I also provide some
  254. examples on the diskette.
  255.  
  256.         But back to your original question: What can this do for
  257. non-programmers?  Well, you will probably find the utilities useful, and
  258. you may be interested in looking at the geometric details of an object
  259. (OK, maybe not :-).
  260.  
  261.         Most definitely, though, the power of the package comes from
  262. being able to algorithmically generate or modify objects and scenes for
  263. animating or for simply creating/modifying complex objects.
  264.  
  265.         Helge Rasmussen, for example, created a program called
  266. "igensurf" that uses the TTDDD format and filters to generate basically
  267. any surface that you can describe mathematically in closed form.
  268.  
  269.         Steve Worley, for another example, created an animation of a
  270. waterfall by algorithmically controlling the positions of thousands of
  271. little spheres.
  272.  
  273.         I, for a third example, created the steam locomotive object on
  274. hubcap with the help of TTDDD, and animated the pistons and wheels.
  275.  
  276.         One of my registered shareware users has a cabinetry business
  277. and models all cabinets and drawers using TTDDD first, and presents a
  278. video of his plans to the customer before he ever starts, making each
  279. presentation expressly unique for that person's kitchen or room.
  280.  
  281.         Feel free, if you have any questions, to send me e-mail.  I hope
  282. I have answered any questions you have, without attempting to make this
  283. a commercial.
  284.  
  285.         Future work includes general object morphing for Imagine such
  286. that *any* two objects can be morphed from one to the other, with T3DLIB
  287. creating all the in-betweens, since Imagine currently can only morph two
  288. objects with the same topology (points/edges/faces).
  289.  
  290.         Of course, work on this will not continue until Steve Worley and
  291. I finish up Essence and ship it.  :-)  [Hmmm... as of release 34, that is
  292. not longer an excuse, so I will have to think of another good one.  :-) ]
  293.  
  294.                                                         -- Glenn
  295.  
  296. Glenn Lewis | glewis@pcocd2.intel.com | These are my opinions...not Intel's
  297.